<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - Virtual Console Frame</TITLE>
<SCRIPT SRC="utility.js" TYPE="text/javascript"></SCRIPT>
<link href="style.css" rel="stylesheet" type="text/css" />
</HEAD>
<BODY onLoad="replaceqrc()">

<H1><IMG SRC="qrc:/frame.png" ALIGN="absmiddle"> Virtual Console Frame</H1>

<P>
A Frame is a container that can hold a variety of widgets, including other frames, inside. In
fact, the whole Virtual Console is already your bottom-most frame. Also, if you
apply some <A HREF="vcstylingplacement.html">styling attributes</A> to a frame,
all of its children (which have not had their own non-default style settings applied) also
inherit their parent's style properties.
</P>

<a name="configuration"><H2>Configuration</H2></a>

<P>
Frames can be configured with the properties
<IMG SRC="qrc:/edit.png" ALIGN="bottom"> button found in the toolbar or
by double clicking the frame itself.<br><br>

Other than the standard <A HREF="vcstylingplacement.html">styling &amp; placement options</A>,
Frames have the following additional options, divided into 2 tabs:<br>
</P>

<a name="appearance"><H3>Appearance tab</H3></a>
<ul>
 <li><b>Frame name</b>: Allow you to assign an arbitrary label to the Frame. This will be displayed
    only when the "Show header" option is enabled (see below).</li>
 <li><b>Accept child widgets</b>: Allow you to add widgets to the Frame.</li>
 <li><b>Allow resizing</b>: Allow the Frame height and width to be changed.</li>
 <li><b>Show header</b>: Display the frame header. By default it will display 3 elements:
 An expand/collapse button, the frame name and a enable/disable button. Some further optional
 controls are displayed when the Frame is in multipage mode. See next paragraph.
 </li>
</ul>

<a name="pages"><H3>Pages tab</H3></a>
<P>Virtual Console Frames can be turned into multi-page widgets, useful when dealing with a lot of widgets or controllers supporting pages.<br>
The multi-page functionality is disabled by default, but can be enabled in this tab.<br>
Following the options to configure this functionality:
</P>
<ul>
 <li><b>Enable</b>: This check box enables/disables the multi-page functionality. When enabled,
     VC frames will display additional controls in the header bar (if the header bar is also enabled).
     These are: Previous page button, page name and next page button.
 </li>
 <li><b>Number of pages</b>: With this counter it is possible to determine the number of pages the
     frame is going to handle.
 </li>
 <li><b>Clone first page widgets</b>: When checked, QLC+ will clone the widgets of the frame's first
     page into all the other new pages defined by the "Number of pages" field. This is a very useful
     option to speed up the mapping of an external controller where all the pages have the same widgets.
 </li>
 <li><b>External input - Previous page</b>: You can set an external input signal or a
     keyboard combination here which will cause the previous page of the frame to be displayed.
 </li>
 <li><b>External input - Next page</b>: You can set an external input signal or a
     keyboard combination here which will cause the previous page of the frame to be displayed.
 </li>
 <li><b>Page shortcuts</b>: in the bottom section of the pages tab, it is possible to assign
        to each page a custom name, an external input signal or a keyboard combination.<br>
        In this way a page can be accessed directly without going through the intermediate pages.<br>
 </li>
</ul>

<a name="header"><H2>Header Controls</H2></a>

<P>By default a Frame is displayed with a header. Following a brief description of the
default and optional controls that can be used either in Operate or Design mode.

<UL>
 <LI><IMG SRC="qrc:/expand.png" ALIGN="absmiddle"> <B>Expand/Collapse button</B>: when clicked, the Frame
  size will be dramaticaly reduced, to save space on your Virtual Console. The collapsed state is saved in your project.
 </LI>
 <LI><B>Frame name</B>: a label displaying the Frame name</LI>
 <LI><IMG SRC="qrc:/check.png" ALIGN="absmiddle"> <B>Enable/Disable button</B>: when clicked, the Frame will go into a
  disable state. All the widgets inside the Frame will not respond anymore to input controls.<br>
  This is useful, for example, to use the same input controls on widgets of different frames.
  For example if you bound the key "G" to a button in Frame A and also to a button on Frame B, you can enable
  one Frame at a time to use your key binding univocally.
 </LI>
 <LI><IMG SRC="qrc:/back.png" ALIGN="absmiddle"> Page <IMG SRC="qrc:/forward.png" ALIGN="absmiddle">
  <B>Multipage controls</B> (Optional): when a Frame is configured in multipage mode, some extra buttons will be displayed on
  the header, allowing you to switch between the Frame pages and to keep track of the current page you're in.
 </LI>
</UL>

</BODY>
</HTML>
